/**
 * @(#)EnlaceTransaccional.java Nov 5, 2006
 *
 * Copyright (c) 2005-2010 Psiqueware S.A. de C.V. All Rights Reserved.
 * This software is the proprietary information Psiqueware S.A. de C.V.
 * Use is subject to license terms.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * <br/>Usuario : AngelElectrico
 * <br/>Creaci&oacute;n: Nov 5, 2006 - 9:04:53 PM
 * <br/>
 * <br/>
 * <br/><t5>Cambios :</t5>
 * <br/><b>Fecha | Autor  |  Cambios</b>
 * <ul>
 * <li>Nov 5, 2006 | <a href = "mailto:AngelElectrico@PsiqueWare.com">Angel El&eacute;ctrico</a> | Creaci&oacute;n del Objeto.</li>
 *
 * </ul>
 */

package com.psiqueware.alheli.dao;

/**
 * Esta interfase intenta proveer de una capa com&uacute;n para poder
 * realizar transacciones at&oacute;micas en el curso Manager - Dao y Manager - Manager.
 * <br/>Paquete Original: com.psiqueware.basico.dao
 * <br/>Nombre  Original: EnlaceTransaccional
 * <br/>Oprima para ver : <a href="EnlaceTransaccional.java.html"><i>C&oacute;digo Fuente</i> </a>
 *
 * @author <a href="mailto:AngelElectrico@PsiqueWare.com">Angel El&eacute;ctrico</a>
 * @version Revision: 1.1 Nov 5, 2006 9:04:53 PM
 */
public interface EnlaceTransaccional
{

    /**
     * Devuelve el {@link TipoDAO} que debe utilizar este {@link EnlaceTransaccional}.
     *
     * @return el {@link TipoDAO} para este {@link EnlaceTransaccional}.
     */
    TipoDAO getTipo();

    /**
     * Inicia una transaccion.
     */
    void iniciaTransaccion();

    /**
     * Devuelve el objeto del cual estamos haciendo nuestra transaccion.
     *
     * @return Object para hacerle casting dependiendo nuestra capa de datos.
     */
    Object continuaTransaccion();

    /**
     * Finaliza la transaccion, en este punto ya no se puede hacer rollback.
     */
    void finalizaTransaccion();

    /**
     * Invoquese si sucede un problema con la transaccion.
     */
    void rollBack();

    /**
     * Devuelve el n&uacute;mero de transacciones que se llevan realizadas por este {@link EnlaceTransaccional}.
     * Generalmente la implementaci&oacute;n implica contar el n&uacute;mero de veces que se ha llamado a continuaTransaccion.
     *
     * @return n&uacute;mero de transacciones.
     *
     * @see this#continuaTransaccion()
     */
    int numeroTransacciones();
}
